<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
  <link rel="stylesheet" href="stylesheets/screen.css" type="text/css" media="screen" />
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <title>
      Ruby Dialog Interface
  </title>
  <script src="javascripts/rounded_corners_lite.inc.js" type="text/javascript"></script>
<style>

</style>
  <script type="text/javascript">
    window.onload = function() {
      settings = {
          tl: { radius: 10 },
          tr: { radius: 10 },
          bl: { radius: 10 },
          br: { radius: 10 },
          antiAlias: true,
          autoPad: true,
          validTags: ["div"]
      }
      var versionBox = new curvyCorners(settings, document.getElementById("version"));
      versionBox.applyCornersToAll();
    }
  </script>
</head>
<body>
<div id="main">

    <h1>Ruby Dialog Interface</h1>
    <div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/rdialog"; return false'>
      Get Version
      <a href="http://rubyforge.org/projects/rdialog" class="numbers">0.5.0</a>
    </div>
    <h1>&#x2192; &#8216;rdialog&#8217;</h1>


	<h2>What</h2>


	<p>Interface with the command-line curses interface dialog, and rapidly develop
simple dialog-driven <span class="caps">TUI</span> applications</p>


	<h2>Installing</h2>


<h1>Install dialog on your machine.</h1>

<h1><pre syntax="ruby">sudo gem install rdialog</pre></h1>





	<h2>The basics</h2>


	<p>After installation is complete, require the gem in your source code, and away you go!</p>


	<p>RDialog handles the interface between ruby scripts and dialog&#8217;s command-line interface. RDialog accepts input as arrays and/or strings, and returns similar objects.</p>


	<p>Once you have initialized an instance of RDialog via <pre syntax="ruby">RDialog.new</pre> , options can be set that will persist throughout the lifetime of the instace. For example:</p>


<pre syntax="ruby">
dialog = RDialog.new
dialog.shadow = false
</pre>

	<p>This will prevent dialog from drawing shadows around all further boxes.</p>


	<h2>Demonstration of usage</h2>


<pre syntax="ruby">
require "rdialog" 

items = Array.new
items.push(["softcheese.net", "a cool server", false])
items.push(["filter.eu.org", "an even cooler server!", false])
items.push(["oink.me.uk", "quite cool as well", true])

dialog = RDialog.new

dialog.nocancel = true
selected_item = dialog.radiolist("ssh to:", items)

exec("ssh sweeper@" + selected_item)
</pre>

	<h2>Forum</h2>


	<p><a href="http://groups.google.com/group/rdialog">http://groups.google.com/group/rdialog</a></p>


	<h2>Licence</h2>


	<p>This code is free to use under the terms of the <span class="caps">MIT</span> licence.</p>


	<h2>Contact</h2>


	<p>Comments are welcome. Send an email to <a href="mailto:aleks.clark@gmail.com">Aleks Clark</a>.</p>
    <p class="coda">
      <a href="mailto:drnicwilliams@gmail.com">Dr Nic</a>, 21st May 2007<br>
      Theme extended from <a href="http://rb2js.rubyforge.org/">Paul Battley</a>
    </p>
</div>

<!-- insert site tracking codes here, like Google Urchin -->

</body>
</html>
